home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / ubound.z / ubound
Encoding:
Text File  |  1998-10-30  |  2.7 KB  |  62 lines
  1. UBOUND(3I)                                             Last changed: 1-6-98
  2.  
  3.  
  4. NNAAMMEE
  5.      UUBBOOUUNNDD - Returns all the upper bounds of an array or a specified upper
  6.      bound
  7.  
  8. SSYYNNOOPPSSIISS
  9.      UUBBOOUUNNDD (([AARRRRAAYY==] _a_r_r_a_y [,,[DDIIMM==]_d_i_m]))
  10.  
  11. IIMMPPLLEEMMEENNTTAATTIIOONN
  12.      UNICOS, UNICOS/mk, and IRIX systems
  13.  
  14. SSTTAANNDDAARRDDSS
  15.      Fortran 90
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      The UUBBOOUUNNDD intrinsic function returns all the upper bounds of an array
  19.      or returns a specified upper bound.  It accepts the following
  20.      arguments:
  21.  
  22.      _a_r_r_a_y     Can be of any type.  It must not be scalar.  It must not be
  23.                a pointer that is disassociated or an allocatable array that
  24.                is not allocated.  If _a_r_r_a_y is an assumed-size array, _d_i_m
  25.                must be present with a value less than the rank of _a_r_r_a_y.
  26.  
  27.      _d_i_m       Must be scalar and of type integer with a value in the range
  28.                1 <= _d_i_m <= _n, where _n is the rank of _a_r_r_a_y.  The
  29.                corresponding actual argument must not be an optional dummy
  30.                argument.
  31.  
  32.      UUBBOOUUNNDD is an inquiry function.  The name of this intrinsic cannot be
  33.      passed as an argument.
  34.  
  35. RREETTUURRNN VVAALLUUEESS
  36.      The result type is default integer.  It is scalar if _d_i_m is present;
  37.      otherwise, the result is an array of rank one and size _n, where _n is
  38.      the rank of _a_r_r_a_y.
  39.  
  40.      For an array section or for an array expression, other than a whole
  41.      array or array structure component, UUBBOOUUNNDD((_a_r_r_a_y,,_d_i_m)) has a value
  42.      equal to the number of elements in the given dimension.  It has a
  43.      value equal to the upper bound for subscript _d_i_m of _a_r_r_a_y if dimension
  44.      _d_i_m of _a_r_r_a_y does not have size zero; it has the value zero if
  45.      dimension _d_i_m has size zero.
  46.  
  47.      UUBBOOUUNNDD((_a_r_r_a_y)) has a value whose _ith component is equal to
  48.      UUBBOOUUNNDD((_a_r_r_a_y,,_i)), for _i = 1, 2, ..., _n, where _n is the rank of _a_r_r_a_y.
  49.  
  50. EEXXAAMMPPLLEESS
  51.      Assume that AA is declared by the statement RREEAALL AA((22::33,, 77::1100)).  In this
  52.      case, the following are true:
  53.  
  54.      * UUBBOOUUNNDD((AA)) is [3, 10]
  55.  
  56.      * UUBBOOUUNNDD((AA,, DDIIMM == 22)) is 10.
  57.  
  58. SSEEEE AALLSSOO
  59.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-2138, for the
  60.      printed version of this man page.
  61.  
  62.